home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 1 / CU Amiga Magazine CD-ROM Special Edition (1995)(EMAP Images)(GB)[Issue 1995-11].iso / Aminet / misc / emu / prlink_amiga.lha / prlink-0.8.0a / README.Amiga next >
Text File  |  1995-05-12  |  6KB  |  179 lines
  1. README.Amiga
  2. ============
  3.  
  4. This is the binary distribution package of prlink, with binaries for Amiga,
  5. Commodore 64, Commodore 128, VIC-20, PET 8032/4032, PET 3032.
  6.  
  7. There are versions for each of the Amiga supported cables: prlink, prlink88
  8. and transnib.
  9.  
  10. All 6502 binaries are compiled with just one type of memory expansion (PIA
  11. expansion) if applicable, since there would be too many combinations
  12. otherwise. You can always generate your own specific version if you want;
  13. you will need DASM 2.02 for this.
  14.  
  15. I haven't tried all these binaries - so if they don't work you will need to
  16. compile/assemble your own.
  17.  
  18. Here is an overview of the directory structure:
  19.  
  20.      src (dir)
  21.       include (dir)
  22.         cbmrom.lib                 petram34.lib
  23.         petrom3.lib              petrom4.lib
  24.        basic-listing            chosen.inc
  25.        COPYING                jmptab.inc
  26.        MakeAll                Makefile
  27.        options.inc            petscii.c
  28.        pramiga.c            prcart.c
  29.        prdisk.asm            prdisk.c
  30.        prload.c             prmain
  31.        prmain.c             prrfile.asm
  32.        prrfile.c            prsample.asm
  33.        prsample.c            prsave.c
  34.        prserver.asm            prtrans.h
  35.        prtrans2.c            prtrans4.c
  36.        prtrans8.c            prwfile.asm
  37.        prwfile.c            README
  38.      amiga (dir)
  39.       libs (dir)
  40.         ixemul.library
  41.        prmain-prlink            prmain-prlink88
  42.        prmain-transnib
  43.      pet3001 (dir)
  44.        prdisk.prg            prrfile.prg
  45.        prserver-prlink.prg        prserver-prlink88.prg
  46.        prserver-transnib.prg        prwfile.prg
  47.      pet4001 (dir)
  48.        prdisk.prg            prrfile.prg
  49.        prserver-prlink.prg        prserver-prlink88.prg
  50.        prserver-transnib.prg        prwfile.prg
  51.      c64 (dir)
  52.        prdisk.prg            prrfile.prg
  53.        prsample-prlink.prg        prserver-prlink.prg
  54.        prserver-prlink88.prg        prserver-transnib.prg
  55.        prwfile.prg
  56.      vic20 (dir)
  57.        prdisk.prg            prrfile.prg
  58.        prserver-prlink.prg        prserver-prlink88.prg
  59.        prserver-transnib.prg        prwfile.prg
  60.      c128 (dir)
  61.        prdisk.prg            prrfile.prg
  62.        prsample-prlink.prg        prserver-prlink.prg
  63.        prserver-prlink88.prg        prserver-transnib.prg
  64.        prwfile.prg
  65.   README.Amiga
  66.  
  67. You must collect the files you need from the various subdirectories named
  68. after the machine they run on, and get the version with the name of your
  69. cable. Rename each so that the -cabletype part is removed. So you end up
  70. with a directory similar to this:
  71.  
  72. prmain               21280 ----rwed Today     17:18:44
  73. prserver.prg             378 ----rwed Today     21:57:18
  74. prsample.prg              32 ----rwed Today     21:57:18
  75. prwfile.prg             175 ----rwed Today     21:57:03
  76. prrfile.prg             169 ----rwed Today     21:57:03
  77. prdisk.prg             477 ----rwed Today     21:57:03
  78.  
  79. To create the other commands (prcart prdisk prload prrfile prsample prsave
  80. prwfile) you can make symbolic or hard links to prmain. If your version
  81. of AmigaDOS does not support links (or does not support them well enough),
  82. not to worry. You can always use a command of the form
  83.  
  84.     prmain --prsave
  85.  
  86. instead of
  87.  
  88.     prsave.
  89.  
  90.  
  91. Here are some useful aliases I have set up (the disk drive in my PET 8296-D
  92. has device number 9):
  93.  
  94.     alias prload prmain --prload
  95.     alias prsave prmain --prsave
  96.     alias prcart prmain --prcart
  97.     alias prsample prmain --prsample
  98.     alias prrfile prmain --prrfile -d 9
  99.     alias prwfile prmain --prwfile -d 9
  100.     alias prdisk prmain --prdisk -d 9
  101.  
  102.     alias @$0 prmain --prrfile -d 9 "$0"
  103.     alias @$1 prmain --prrfile -d 9 "$1"
  104.  
  105. You can, if you wish to use multiple types of cables, change the aliases
  106. a bit, to something like
  107.  
  108.     alias prrfile8 prmain-prlink88 --prrfile -l prrfile-prlink88.prg
  109.  
  110. The "Transnib" cable isn't described in the main documentation (a small
  111. oversight on my part), so here is what pramiga.c has to say about it:
  112.  
  113.   TransNib is a cable that has only 6 bits connected:
  114.  
  115.   0-3:      data i/o
  116.   6:      handshake in
  117.   7:      handshake out
  118.  
  119.   Because the cable is straight-through, bits 6 and 7 are swapped
  120.   at the PET/C-64/VIC-20 side.
  121.  
  122.   The protocol is provided for people who made a cable for
  123.   TransNib V1.00 Devised by Matt Francis (m.p.francis@newcastle.ac.uk).
  124.   Because the cable is a subset of the prlink cable it will also work
  125.   with that.
  126.  
  127.   Note that this protocol is not compatible with the TransNib programs!
  128.  
  129. Usage summary of the subprograms:
  130.  
  131. prload: Uploads files to a memory area on a remote computer.
  132.  
  133. Usage: prload [options] filename(s)
  134. Options:
  135.     -a addr Override the load address from the file
  136.     -b bank Specify the memory bank (in hex)
  137.     -l    Load the file as BASIC.
  138.     -r    Performs the BASIC RUN command after the transfers.
  139.     -j addr Jumps to the specified hex address after the transfers.
  140.     -p port Specify the printer port (0 to 3)
  141.  
  142. prsave: Dumps a memory area on a remote computer to a file or standard output.
  143.  
  144. Usage: prsave [options] startaddress endaddress [filename]
  145. Options:
  146.     -b bank Specify the memory bank (in hex)
  147.     -p port Specify the printer port (0 to 3)
  148.  
  149. prdisk: Copies a file to or from a disk accessible  from a remote computer.
  150.  
  151. Usage: prdisk [options] [filename]
  152. Options:
  153.     -d device    Specify the device number (0-15)
  154.     -r    Specify read operation (default)
  155.     -w    Specify write operation
  156.     -l filename    Specify the filename of the client program
  157.     -p port Specify the printer port (0 to 3)
  158.  
  159. prrfile: Dumps a file accessible from a remote computer to a file.
  160.  
  161. Usage: prrfile [options] filename [local filename]
  162. Options:
  163.     -d device    Specify the device number (0-15)
  164.     -l filename    Specify the filename of the client program
  165.     -p port Specify the printer port (0 to 3)
  166. The filename can start with a $, in which case it is
  167. printed as a directory, unless a local name is given.
  168. The remote filename is converted to PETSCII.
  169. The default local file name has / characters converted to -.
  170. prwfile: Writes a local file to a file on a remote computer.
  171.  
  172. Usage: prwfile [options] filename [remote filename]
  173. Options:
  174.     -d device    Specify the device number (0-15)
  175.     -l filename    Specify the filename of the client program
  176.     -p port Specify the printer port (0 to 3)
  177. The remote filename is converted to PETSCII.
  178.  
  179.